home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / miscellaneous / help / dos / dosman / man / mount < prev    next >
Encoding:
Text File  |  1996-09-07  |  10.6 KB  |  284 lines
  1.  
  2.  
  3.  
  4.            Mount(V1.3, 2.x, 3.x in C:)
  5.  
  6.  
  7.  
  8.      NAME
  9.           Mount - Make a new device known to AmigaDOS.
  10.  
  11.      SYNOPSIS
  12.           1.3:
  13.           MOUNT Dev [FROM filename] 
  14.  
  15.  
  16.           2.x/3.x:
  17.           MOUNT Devs [FROM filename]
  18.  
  19.      DESCRIPTION
  20.             When AmigaDOS starts up, only a few devices are known 
  21.         to it.  You can add new devices with the Mount command, 
  22.         which are then used just like any standard device.  The 
  23.         devices might be actual hardware units, or they might be 
  24.         logical devices, such as a SPEAK: device, or a PIPE:  
  25.         device, or a buffered serial device SER:, or even a 
  26.         non-buffered serial device such as AUX:.  The Assign 
  27.         command allows you to view or remove these added devices, 
  28.         as well as the standard system devices.
  29.  
  30.             Before using this command to Mount the device, you 
  31.         will need to create an entry for it in a file (this is 
  32.         referred to as a MountList entry).  The details of doing 
  33.         this vary from device to device, but there should be 
  34.         documentation accompanying each device you intend to add 
  35.         that describes exactly how to do this.  Ordinarily, you 
  36.         will make this entry in the file called DEVS:Mountlist on 
  37.         your system, but the FROM keyword gives you the option to 
  38.         specify another file to obtain the mountlist entry from. 
  39.         The 1.3 disk has a sample Mountlist file in the Devs: 
  40.         directory. This will form a good example of how to 
  41.         structure any mountlists you write.
  42.  
  43.             The size of the device is determined by the Surface, 
  44.         LowCyl, HighCyl, and BlocksPerTrack entries. Merely 
  45.         multiply these values together to get the available 
  46.         storage. For example, if you had a device with a 
  47.         Surface=2 (double sided), LowCyl= 0 and HighCyl=39 (40 
  48.         tracks per side: 39 - 0 + 1), and with a 
  49.         BlocksPerTrack=11 (11 sectors, each sector being 512 
  50.         bytes) you would end up with a 440k drive (.5k X 2 X 11 X 
  51.         40= 440K).
  52.  
  53.             For non-memory devices such as SPEAK:, AUX:, SER:, or 
  54.         PIPE: the list simply shows where to find the handler. A 
  55.         handler is a program similar to a device driver.
  56.  
  57.             The CLI commands FORMAT and DISKCOPY work with all 
  58.         similar mounted devices. For instance, you can FORMAT or 
  59.         DISKCOPY between two 3.5 inch drives and two 5.25 inch 
  60.         drives, but not DISKCOPY between a 5.25-inch drive to a 
  61.         3.5-inch drive.  If you try, you will get an "Object Not 
  62.         Of Required Type" message.
  63.  
  64.             The MOUNT command looks for this Mountlist in the 
  65.         DEVS: directory. This file is a text file that shares 
  66.         some of the characteristics of the C programming 
  67.         language. For instance, hexadecimal numbers must start 
  68.         with the characters 0x. Semicolons must seperate multiple 
  69.         descriptions on a line. Comments must appear like in all 
  70.         AmigaDOS script comments, that is beginning with /* and 
  71.         ending with */. The Mountlist must end with the pound 
  72.         sign (ei #).
  73.  
  74.             2.X/3.X Only:
  75.  
  76.             There is a completely new and user-friendly way to 
  77.         handle devices! There is a new drawer in your Workbench 
  78.         called "DOSDrivers" inside your DEVS: directory. These 
  79.         files are different from old mountlists in three ways: 1) 
  80.         They don't end in a pound sign, 2) They contain only one 
  81.         device name per file, and 3) the device name of the file 
  82.         is not specified in the list. To mount the device, you 
  83.         simply drag it into the DOSDrivers drawer and it will be 
  84.         mounted automatically when the Workbench is loaded.  If 
  85.         you don't want the mountlist loaded automatically at 
  86.         startup, then simply place the mountlist in the 
  87.         DOSDrivers drawer of the Storage directory.
  88.  
  89.       KEYWORDS FOUND IN THE MOUNT LIST
  90.           Handler= 
  91.             The name of the device handler file. Found in you l 
  92.         or devs directory of your workbench.
  93.  
  94.           EHandler=
  95.             2.x/3.x only: The name of the environment handler 
  96.         file found in your prefs/env-arc directory of your 
  97.         workbench.
  98.  
  99.           FileSystem= 
  100.             The name of the file system file. Usually found in 
  101.         your Devs or l directory of your Workbench.
  102.  
  103.           Device=  
  104.             The name of your device driver file found in the Devs 
  105.         drawer of your workbench. You can also specify a path to 
  106.         another device location if you to locate the  driver in 
  107.         another drawer.
  108.  
  109.           Priority= 
  110.             The task priority of the process; 5 is typical of 
  111.         handlers, 10 is typical of file systems.
  112.  
  113.           Unit= 
  114.             The unit number of the device (ei 0 for df0: and 1 
  115.         for df1:).
  116.  
  117.           Flags=  
  118.             Flags setting for the OpenDevice call (usually 0).
  119.  
  120.           Surfaces= 
  121.             Number of write surfaces.
  122.  
  123.           BlocksPerTrack:
  124.             The number of disk blocks (eg sectors) per track (eg 
  125.         cylinder).
  126.  
  127.           Reserved= 
  128.             The number of blocks used for the boot block; 2 is 
  129.         the standard here.
  130.  
  131.           PreAlloc= 
  132.             The number of blocks reserved at the end of a 
  133.         partition; used with a few IBM-style (yuk!) hard drives. 
  134.         This is usually 0.
  135.  
  136.           Interleave=
  137.             This value controls the AmigaDOS interleave, not the 
  138.         physical hard drive interleave.
  139.  
  140.           LowCyl=
  141.             Starting cylinder to use for this device.
  142.  
  143.           HighCyl= 
  144.             Ending cylinder for this device. Total number of 
  145.         cylinders= HighCyl - LowCyl +1. 
  146.  
  147.           StackSize=
  148.             The amount of working memory to allocate to the 
  149.         process.
  150.  
  151.           Buffers=
  152.             Number of cache buffers to use with the device.
  153.  
  154.           BufMem Type=
  155.             Type of memory to use for cache buffers. Values are 
  156.         as follows: 
  157.                             0 or 1 = Any
  158.                             2 or 3 = CHIP
  159.                             4 or 5 = FAST
  160.  
  161.           Mount=
  162.             If this value is positive, MOUNT loads the handler or 
  163.         driver software as soon as the device is MOUNTed, rather 
  164.         than the first time the device is accessed.  2.1/3.x 
  165.         utilizes the word ACTIVE as a synonym for this keyword.
  166.  
  167.           MaxTransfer=
  168.             The maximum number of blocks transfered at one time; 
  169.         used with the Fast File System only.
  170.  
  171.           Mask= 
  172.             Address mask that specifies the memory range that can 
  173.         be used for DMA transfers; used only with the Fast File 
  174.         System.
  175.  
  176.           GlobVec= 
  177.             If the handler is written in BCPL, it needs a global 
  178.         vecotr. A value of 0 sets up a private global vector; 
  179.         anything else indicates that the handler is written in C 
  180.         or assembly language, and no global vector is needed.  If 
  181.         this keyword isn't used, the shared AmigaDOS global 
  182.         vector is used.
  183.  
  184.           Startup=
  185.             A string passed to the handler, device, or file 
  186.         system on startup. This string is passed as a BPTR to a 
  187.         BSTR.
  188.  
  189.           BootPri=
  190.             The boot priority of a bootable device, expressed as 
  191.         a number between -129 and 127. A value of -129 indicates 
  192.         that the device is not bootable, as is appropriate for 
  193.         use with the recoverable RAM disk if you don't want to 
  194.         boot from that device on reset.
  195.  
  196.           DosType=
  197.             Indicates the format of the file system used. If the 
  198.         Fast File System is used, this value should be set to 
  199.         0x444F5301 (DOS/1). Other types introduced in 2.1 include 
  200.         0x444F5302 (DOS/2), an international version of the old 
  201.         file system that allows mixed-case accented characters in 
  202.         filenames, and 0x444F5303 (DOS/3), an international 
  203.         version of the Fast File System.
  204.  
  205.           Baud=    
  206.             Serial device speed (in bits per second).
  207.  
  208.           Control=  
  209.             Serial device control parameters- word length, 
  210.         parity, and stop bits (eg 8N1, 7E1).
  211.  
  212.           ForceLoad=
  213.             A new 2.1 option. When this value is 0 (default), the 
  214.         system will check the resource list to see if the file 
  215.         system named in the entry has already been loaded. If it 
  216.         has, the system will use that one, instead of loading a 
  217.         new one.        
  218.           
  219.  
  220.             Under 1.3 you can only MOUNT one device at a time 
  221.         with one MOUNT command.
  222.         
  223.             The 2.x/3.x version of Mount allows you to mount any 
  224.         number of devices with one Mount command, which can speed 
  225.         up the startup-sequence somewhat.
  226.  
  227.  
  228.      OPTIONS
  229.           FROM
  230.             This takes one argument, which should be a filename.  
  231.         This filename will be used to obtain the Mountlist entry 
  232.         for the device you are adding. If this keyword is not 
  233.         used, the file DEVS:Mountlist will be used instead.
  234.  
  235.           
  236.     MOUNT KEYWORDS
  237.         
  238.     DEV
  239.             The actual AmigaDOS device name, such as DF2:, DH0:, 
  240.         or SER:.  This refers to either a hardware device like a 
  241.         disk drive or serial port, or a logical device such as a 
  242.         RAD or harddrive partition. The keyword must be the same 
  243.         as the label given in the Mountlist entry. The device 
  244.         mounted should also be available to the system. 
  245.  
  246.             In 1.3 you can only specify one device per command. 
  247.         Under 2.x/3.x you can specify multiple devices with one 
  248.         command call. Wildcards may be used when specifying 
  249.         multiple devices.
  250.  
  251.     FROM
  252.             Lets you specify a file other than DEVS:Mounlist as 
  253.         the place to look for the description of the device being 
  254.         MOUNTed.
  255.  
  256.      EXAMPLE
  257.            1. Assuming you have a mountlist for a device named 
  258.         FRANKIE:
  259.  
  260.                Mount FRANKIE:
  261.  
  262.       CAUTIONS
  263.  
  264.             Please note the following two differences between the 
  265.         V2.x/3.x Mount and the Commodore V1.3 Mount, which can 
  266.         cause problems in some cases if you are not aware of the 
  267.         differences.
  268.  
  269.             If you want to reboot from RAD: using the 2.x/3.x 
  270.         Mount, you must insert an explicit "BOOTPRI = 0" 
  271.         statement into the mountlist entry for RAD:, as compared 
  272.         with the Commodore Mount which automatically will reboot 
  273.         from RAD:.
  274.  
  275.             If you have a "MASK = nnnnn" statement in your 
  276.         mountlist, MAKE SURE THE MASK VALUE IS AN EVEN NUMBER.  
  277.         The 1.3 Mount automatically converts the mask value to an 
  278.         even value, but the 2.x/3.x Mount will pass through an 
  279.         odd value which can cause problems.  You will probably 
  280.         only have a "MASK=nnnnnn" statement if you have memory 
  281.         that cannot be accessed by a DMA device, such as with a 
  282.         RONIN 68020 card.
  283.  
  284.